home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / hypercrd / xcmds / shwdlg16.hqx / About ShowDialog XCMD 1.6 next >
Text File  |  1993-04-25  |  9KB  |  207 lines
  1. 25 April 1993
  2.  
  3. This Stuffit(tm) archive contains this text document and Jay 
  4. Hodgdon's HyperCard(tm) external package "ShowDialog" version 1.6.  
  5. ShowDialog allows the creation of a wide variety of dialogs within 
  6. HyperCard that are more "Mac-like" and much more flexible that the 
  7. built-in answer and ask (and their variations) commands.  
  8. ShowDialog supports scrolling lists, radio buttons, checkboxes, 
  9. icons (including COLOR), PICTs, and much more to be displayed in 
  10. dialogs.
  11.  
  12. I have been using this external package for several years.  I've 
  13. found it to be extremely well done, and it has held up well 
  14. through several versions of HyperCard.  I've used it with 1.1, 
  15. 1.2x, 2.0x, and the current (as of April, '93) 2.1 without major 
  16. problems.  Some of the externals included are no longer needed in 
  17. the current version of HC, however.  Also, there are some *minor* 
  18. idiosyncrasies that I've learned to work around.  There is also at 
  19. least one commercial set of externals that go well beyond what is 
  20. possible with ShowDialog, but ShowDialog is only five bucks!!  
  21. Recently on the HYPERCRD list and comp.sys.mac.hypercard there has 
  22. been some discussion about creating dialogs in HC and several 
  23. requests for posting this stack.
  24.  
  25. To make use of ShowDialog XCMD you will need ResEdit or some other 
  26. resource editor.  The stack provides a great deal of help with 
  27. this, but it is somewhat dated (discusses ResEdit 1.2).
  28.  
  29. When I sent my shareware payment to Mr. Hodgdon back in '90, I 
  30. received a disk from him with version 1.6 of ShowDialog.  Included 
  31. with the disk was a three page printed document describing some of 
  32. the changes to the stack.  I include the text of that document 
  33. here.
  34.  
  35. Please note that Mr. Hodgdon passed away in January 1991.  This 
  36. stack is shareware (terms and pricing included in the stack's 
  37. documentation), and prior to his death Mr. Hodgdon requested that 
  38. payments be made as listed below.  This information is from Steve 
  39. Michel's StackWEEK column in the 26 March *1991* (yes, '91) issue 
  40. of MacWEEK:
  41.  
  42. "In January, Jay Hodgdon, noted XCMD developer and HyperCard 
  43. tester on Apple's HyperCard team, died of complications from 
  44. AIDS....
  45.  
  46. "Before his death, he requested that future shareware payments and 
  47. contributions be sent to two San Francisco charities:  Project 
  48. Open Hand and The Names Project AIDS Memorial Quilt....
  49.  
  50. "The Names Project AIDS Memorial Quilt is at 2362 Market St., San 
  51. Francisco, Calif. 94144.  Phone (415) 863-5511, fax (415)863-0708.
  52.  
  53. "Project Open Hand is at 2720 17th St., San Francisco, Calif. 
  54. 94110.  Phone (415) 558-0600."
  55.  
  56. Disclaimer:  I have no affiliation with the above organizations, 
  57. and I never met Mr. Hodgdon.  However, I think this stack and 
  58. associated externals are excellent work, and I'm a satisfied user.  
  59. Compiling this little document and posting this last version of 
  60. the stack is just my tribute...
  61.  
  62. And now, the promised document:
  63.  
  64.  
  65. "Wednesday, May 24, 1989
  66.  
  67. Dear HyperCard Developer:
  68.  
  69. Thank you for supporting ShowDialog XCMD.  Enclosed is version 1.6 
  70. of ShowDialog, which is the most recent revision.. If you have 
  71. been using a preliminary version of 1.6, please discard the demo 
  72. stack and substitute this current version in its place.  You will 
  73. need to make no modifications to your scripts.
  74.  
  75. If you have been using versions of ShowDialog prior to 1.6, you 
  76. *cannot* substitute the current version in your previously written 
  77. stacks without modifying your scripts.  Significant changes have 
  78. been made in the function of ShowDialog to enhance its power and 
  79. flexibility.
  80.  
  81. The new features of ShowDialog XCMD 1.6 are:
  82.  
  83. 1.  ShowDialog types 2, 3, and 4 now return their result in a 
  84. RETURN-delimited list, instead of a comma delimited list.  Many 
  85. people expressed dismay that errors would occur in processing the 
  86. result if the user entered commas into the Editable Text fields.  
  87. This problem has been corrected in this version.
  88.  
  89. 2.  ShowDialog types 2, 3, and 4 can now have AS MANY fields of 
  90. Editable Text as you desire.  The limit of two fields has been 
  91. removed.  The user simply tabs through the fields of Editable Text 
  92. in the dialog.  The result contains the contents of the Editable 
  93. Text fields in a RETURN -delimited list.
  94.  
  95. 3.  ShowDialog type 2 can now contain as many check boxes as you 
  96. desire.
  97.  
  98. 4.  You can no longer specify the window title in the ShowDialog 
  99. type 2 parameter list.  If you're using a procID window of 0 (the 
  100. one with the titlebar), then the window title must be specified in 
  101. the DLOG template.  This parameter was removed because it seemed 
  102. silly to title the dialog on the fly.
  103.  
  104. 5.  If your buttons of a ShowDialog type 5 dialog are of the "hot 
  105. spot" type, they will "invert" to hilite the area of the PICT that 
  106. lies over them.  (See the "All PICT" dialog on the Special Dialogs 
  107. card for more information on this.)
  108.  
  109. 6.  The scrolling list of ShowDialog type 7 can now be configured 
  110. so that only one item can ever be selected, or that multiple items 
  111. can be selected (by shift-clicking to make discontinuous 
  112. selections or shift-click-dragging to make continuous selections).  
  113. This necessitated the addition of another parameter to the 
  114. parameter list.
  115.  
  116. 7.  ShowDialog type 7 can now have as many regular buttons as you 
  117. wish.  Its result is now RETURN-delimited.  Line 1 of the result 
  118. contains the DITL item# of the button clicked.  Line 2 of the 
  119. result is a comma-delimited list of the lines from the scrolling 
  120. list that were hilited.  This allows you to act on the lines of 
  121. the list in a variety of ways (depending on which button was 
  122. clicked).
  123.  
  124. 8.  After a dialog box is dismissed, ShowDialog now forces 
  125. HyperCard to refresh its window.  Therefore, you no longer have to 
  126. issue "go to this card" messages when displaying several dialogs 
  127. within a handler to fill in the white space left by a dialog.
  128.  
  129. 9.  The ShowDialog demo stack now contains explicit step-by-step 
  130. instructions for creating dialogs with ResEdit (as a courtesy to 
  131. those unfamiliar with the operation of ResEdit).
  132.  
  133. 10. Two new auxiliary XCMDs have been added to the ShowDialog 
  134. group:  TextDialog XCMD and SplashDialog XCMD.  CreditsDialog XCMD 
  135. was included with the previous versions of ShowDialog but was 
  136. undocumented.
  137.  
  138. TextDialog XCMD displays a dialog that can show up to 255 
  139. scrolling text screens, each containing up to 32K of text.  You 
  140. specify in the parameter list the font and point size of the text 
  141. in the scrolling field.  A TextDialog dialog is "semi-modal".  It 
  142. can have a titlebar that allows it to be dragged around the 
  143. screen, but it must be dismissed before other actions can be 
  144. taken.
  145.  
  146. Scrolling of the TextDialog field is under full keyboard control:
  147.  
  148. * Pressing the Home or End keys on the extended keyboard will 
  149. scroll the field either to the top or bottom.
  150. * Pressing the arrow up or arrow down keys will scroll the field 
  151. one line at a time.  Pressing these keys with the command key down 
  152. will scroll the field an entire page.
  153. * Pressing the page up or page down keys will scroll the screen 
  154. and entire page.
  155. * Pressing the arrow left or arrow right keys will cycle text 
  156. screens in the same manner as pressing the Prev or Next buttons.
  157. * Pressing enter or return or clicking the goAway box on the 
  158. titlebar cancels the dialog.
  159.  
  160. SplashDialog XCMD displays a dialog containing your graphic that 
  161. dismisses itself after a specified period of time.
  162.  
  163. CreditsDialog XCMD displays a dialog containing two graphic 
  164. elements.  One element is swapped for the other when the dialog is 
  165. first clicked.
  166.  
  167. 11. The ClipToPICT X-command has been rewritten as a function 
  168. (XFCN) and now allows you to insert a PICT from the clipboard not 
  169. only into the current stack, but into any other stack as well.  Or 
  170. you can create a new file ("double-clickable" by ResEdit) to 
  171. contain the PICT resource.
  172.  
  173. 12. PrintDoc XCMD has been revised to provide better error 
  174. handling in situations where the LaserWriter is turned off when 
  175. trying to print or when the "printing" files are missing from the 
  176. System Folder.  It also fixes a gross bug where the XCMD would 
  177. crash the machine if the printing DLOG/DITLs were missing from the 
  178. stack.
  179.  
  180. 13. Ants XFCN now uses an offscreen bitmap and CopyBits to 
  181. eliminate screen flicker when drawing the rectangle.  Ants also 
  182. now flushes the event queue so that the mouseclick that draws out 
  183. the rectangle isn't passed along to HyperCard (this caused a 
  184. problem in scripts where a painting tool was active when Ants was 
  185. called.
  186.  
  187. Many of the modifications in version 1.6 of ShowDialog resulted 
  188. from feedback that I received from users of ShowDialog.  I 
  189. appreciate your comments, suggestions, and criticisms.
  190.  
  191. ShowDialog is a continuously evolving product.  You can expect 
  192. that as HyperCard evolves, so too will ShowDialog.  In future 
  193. versions...." (remainder deleted - JC)
  194.  
  195. "Sincerely yours,
  196.  
  197. Jay Hodgdon
  198. Ignatz Software"
  199. _____________________________________
  200.  
  201. Alas, there will be no future versions.  I hope you find this 
  202. software as useful as I have.
  203.  
  204. Jay Cross    Cross Resources    (216) 286-8282
  205.               by303@Cleveland.Freenet.Edu
  206. HyperCard development,   Macintosh user training,   DTP
  207.